Skip to content

Install on Claude Code, Codex and other agents, with a test for each - #3

Merged
ataniz merged 1 commit into
mainfrom
repo-layout
Nov 5, 2026
Merged

ataniz merged 1 commit into
mainfrom
repo-layout

Conversation

@ataniz

@ataniz ataniz commented Nov 5, 2026

Copy link
Copy Markdown
Contributor

Why

People install skills from Claude Code, Codex and other CLIs, so each route has to work and the README has to say how. This takes marketingskills' repo layout and README shape as the reference.

What changes

  • The README follows marketingskills' framing: who it's for, what skills are, how they fit together, the skills, installation per agent, usage, then contributing.
  • .agents/plugins/marketplace.json is Codex's own marketplace file. Codex already installed through its fallback to .claude-plugin/.
  • The manifests carry no version. With version 0.1.0 unchanged, claude plugin update said "already at the latest version" and the new content never arrived. Without a version, Claude Code updated from one commit to the next. check-skills.mjs now fails on a manifest with a version.
  • scripts/test-installs.sh installs into clean folders as plugins for Claude Code and Codex and through npx skills for 11 agents. --run also asks each signed-in agent to use a skill.
  • .github/workflows/check.yml runs check-skills.mjs and the install test on each pull request.
  • CONTRIBUTING.md, AGENTS.md and CLAUDE.md hold what the README's "Changing the skills" section used to say, plus the repo's rules.

Checked

From the published repo before this change, real sessions on Claude Code and Codex (both routes) and Cursor (npx skills) found the skill, read its reference file and read OpenApps data. OpenCode and Amp weren't run because neither is signed in on this machine. Their files landed, and so did those for Gemini CLI, GitHub Copilot, Windsurf, Cline, Goose and Pi.

I'll repeat this from GitHub after the merge, because the README's test table says it ran from there.

… for each, and every commit on main reaches plugin users
@ataniz
ataniz merged commit 8200278 into main Nov 5, 2026
1 check passed
@ataniz
ataniz deleted the repo-layout branch November 5, 2026 17:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant